.\"                                      Hey, EMACS: -*- nroff -*-
.TH KVM 1 "2008-03-31"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)

.SH NAME
kvm \- x86 emulator with CPU VT support

.SH SYNOPSIS
.B kvm
.RI [ options ] [ disk_image ]
.SH OPTIONS
.TP
.B \-h
Print a summary of all options.
.TP
.B -no-kvm
Disable KVM hardware virtualization.
.TP
All other options
The other options are similar to those of qemu.

.SH DESCRIPTION
.B kvm
is based on qemu and its parameters are the same with the above
additions, please see the kvm-qemu(1) manpage for instructions on how to
run the program.

.SH SETTING UP THE NETWORK
In Debian, kvm uses the configuration script
.I /etc/kvm/kvm-ifup
to initialize the network for the virtual machine on the host side
when starting a virtual machine.  The default script sets up a virtual
switch, so the guest appears to be on the same subnet as the host,
which greatly simplifies setting up networking in the guest operating
system. For example, if the IP adress of the host is 192.168.1.1, the
guest could use 192.168.1.2, with a netmask of 255.255.255.0.

To learn more about setting up the network, please refer to the
following documents:
.TP
.BR "QEMU Documentation" " at"
.I http://qemu.org/user-doc.html
.TP
.BR "Linux Networking-concepts" " at"
.I http://www.netfilter.org/documentation/HOWTO/networking-concepts-HOWTO.html
.TP
.BR "Linux Networking HOWTO" " at"
.I http://tldp.org/HOWTO/NET3-4-HOWTO.html
.TP
.BR "Linux Advanced Routing & Traffic Control HOWTO" " at"
.I http://tldp.org/HOWTO/Adv-Routing-HOWTO/index.html

.SH FILES
.na
.nf
.BR "/etc/kvm/kvm-ifup" ", called at startup to configure the host-side network"
.BR "/usr/share/kvm/" ", BIOS files are by default loaded from this directory"
.BR "/usr/share/kvm/keymaps" ", keymap files"

.SH SEE ALSO
.BR "kvm-qemu" "(1), " "kvm-img" "(1)."
.SH AUTHOR
KVM was written by Avi Kivity from Qumranet.
.PP
This manual page was written by Baruch Even <baruch@debian.org> and
Leonard Norrgard <vinsci@refactor.fi> for the Debian project (but may
be used by others).
